home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / COMMUNIC / BULLETIN / 0157.ZIP / SHUFFLE.DOC < prev    next >
Text File  |  1985-09-25  |  10KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5. SHUFFLE                                                     version 1.30                         (c) 1985 by Robert Lederman
  6.  
  7.                                                        25 September 1985
  8. Description
  9. -----------
  10.  
  11.      SHUFFLE is a time-saving utility which allows Fido sysops easily to
  12. move   files   and  corresponding  FILES.BBS  entries   among   download
  13. directories.  It  also permits rudimentary editing of file descriptions.
  14. Written  in  Borland  International's  Turbo  Pascal  3.01,  SHUFFLE  is
  15. designed to be used locally as  well as remotely, by taking advantage of
  16. ANSI.SYS control codes.
  17.  
  18.  
  19. Requirements
  20. ------------
  21.  
  22.      SHUFFLE requires an IBM PC, XT,  AT,  or  BIOS-compatible  computer
  23. running FIDO, Tom Jennings' remote  bulletin  board system.  A hard disk
  24. is recommended.  When run from a local console, SHUFFLE requires the use
  25. of ANSI.SYS or equivalent device driver.   When  run  remotely,  SHUFFLE
  26. requires  that  the  remote  communications package use  ANSI.SYS  (like
  27. Minitel or Qmodem) or VT100 emulation.
  28.  
  29.      SHUFFLE should be stored on the same subdirectory that contains the
  30. Fido system files (SYSTEMn.BBS).  In any  case,  the  current  directory
  31. MUST contain those Fido files whenever running SHUFFLE.
  32.  
  33.  
  34. Restrictions
  35. ------------
  36.  
  37.      SHUFFLE will work properly only if your  Fido system contains 50 or
  38. fewer file areas.  Undesirable -- not  destructive  --  results  may  be
  39. achieved beyond that limit.
  40.  
  41.      Due to  memory  restrictions,  SHUFFLE  should  NOT  be  used  with
  42. FILES.BBS listings that contain more than 350 lines.   Lines beyond that
  43. limit  will  be  be  lost.  You will be warned if you ever  exceed  this
  44. limit.
  45.  
  46.      FILES.BBS text listings MUST terminate with a cr/lf  before the EOF
  47. marker.  Just hit carriage return when editing the last line of the file
  48. before saving it.  Fido ordinarily terminates FILES.BBS entries in  this
  49. fashion, anyway.
  50.  
  51.      SHUFFLE can not be used to transfer files  between different floppy
  52. disks.  But no harm can be done trying.
  53.  
  54.      DON'T WORRY!  SHUFFLE always  backs  up  the  active  FILES.BBS  as
  55. FILES.BAK before changing anything.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. SHUFFLE v1.30                 -1-             Call Met-Chem 203/281-7287
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76. Operation
  77. ---------
  78.  
  79.      Making sure that the current directory is the  Fido directory, type
  80. SHUFFLE from  DOS  prompt, either locally or after using the '0' command
  81. to exit Fido remotely.  Try using SHUFFLE from a remote terminal -- it's
  82. really neat!
  83.  
  84.      At this point, a simple  description  will be displayed and SHUFFLE
  85. will display a menu of all  file areas, each with the corresponding Fido
  86. area number.
  87.  
  88.      You will now  be  asked  to  choose an active file subdirectory for
  89. viewing, manipulating, and SHUFFLE-ing files.  SHUFFLE will pause a  few
  90. seconds to load the files.bbs and directory  information in the area you
  91. choose Afterwards you will see the following menu:
  92.  
  93. new area#,Edit,Insert,Jump,Kill,Move,Next,Orphan,Previous,Rename,Scan,Quit:
  94.  
  95. and the first entry of your  FILES.BBS.  If the line contains a comment,
  96. it will be marked COMMENT.   A line is considered a comment if the first
  97. character is  a '-', '=', or a ' ' (space), or if the length of the line
  98. is  less  than  two  characters.   Otherwise,  the file name, size,  and
  99. creation date  is  displayed.   If the active directory does not contain
  100. the file listed in the FILES.BBS, then it is marked MISSING.   The  file
  101. description is displayed on the next line.
  102.  
  103.  
  104. Commands
  105. --------
  106.  
  107.      Hitting <Return> will display the next entry in  the files.bbs that
  108. has not  been  deleted or redirected.  SHUFFLE will "wrap" from the last
  109. entry back to the beginning of the FILES.BBS.
  110.  
  111.      The  (N)ext  and  (P)revious  commands  act  as direction  toggles.
  112. Hitting 'P' for example  will  display  the  previous  active  files.bbs
  113. entry, and all subsequent <return>'s will move backwards.   Hitting  'N'
  114. will display  the  next  active entry, and all subsequent <return>s will
  115. move forward.
  116.  
  117.      Entering a NUMBER corresponding to a file area will REDIRECT a file
  118. from the current subdirectory to the selected  file area, and append the
  119. files.bbs entry to the files.bbs of the target area.
  120.  
  121.      The (J)ump  command  directs SHUFFLE to Jump to a specified line in
  122. the FILES.BBS.  You will be prompted for a line number.  If that line no
  123. longer exists  (if  it has been deleted or redirected), then you SHUFFLE
  124. will display the next active line.
  125.  
  126.  
  127.  
  128.  
  129. SHUFFLE v1.30                 -2-             Call Met-Chem 203/281-7287
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.      The (K)ill command permits you  to  delete the current entry and/or
  143. the corresponding file.  You are prompted for each deletion.  Be careful
  144. with this.
  145.  
  146.      The (I)nsert command inserts a  blank  line before the current one,
  147. ready for (E)diting.
  148.  
  149.      The  (E)dit  command  permits  you  to  edit  the   file  name  and
  150. description fields.  To edit the FILES.BBS file description field,  type
  151. your new description and then  hit  <Return>.  SHUFFLE marks the maximum
  152. length  of your entry to  avoid  annoying  "wrap"  using  the  Fido  'F'
  153. command.To edit the FILES.BBS filename field, just type the new filename
  154. you want listed and hit <ESC>.  Notice the wide flexibility this command
  155. permits.  You can  convert  a  filename  entry into a comment by hitting
  156. <ESC>  without  any characters.  After you enter a new  field,  you  may
  157. (S)ave or (D)iscard it.
  158.  
  159.      The (R)ename command  renames  the  current  file  to  the name you
  160. specify, and updates the current FILES.BBS accordingly.  Notice that the
  161. related  (E)dit  filename function does NOT rename any files,  only  the
  162. description in the FILES.BBS.
  163.  
  164.      The (S) command scans for a keyword (up to six characters) that you
  165. enter.  It searches  both  file  names  and  file  descriptions.  If the
  166. keyword  is  found,  you  may  (C)ontinue  to  search   for   additional
  167. occurances, enter  a  (N)ew keyword, or (S)top at the current entry.  If
  168. no matches are found, you can enter a (N)ew keyword or (S)top and return
  169. to  the  original  entry.   Note  that  wildcard  characters   are   NOT
  170. supported.
  171.  
  172.      The (O)rphan command, inspired  by  Bill  Becker  of  Fido  16/209,
  173. searches the  current  directory  for files not listed in the FILES.BBS.
  174. New file entries for the orphans are appended to the end  of  FILES.BBS,
  175. ready for (E)diting or (K)illing.  Note that FILES.BBS,  FILES.BAK,  and
  176. DIR.BBS are excluded from the orphan search.
  177.  
  178.      The (M)ove  command,  modelled  after DOS Edlin, permits a range of
  179. lines to be moved  elsewhere  in  the  current  FILES.BBS.   You will be
  180. prompted for the first line to be  moved (hitting <return> specifies the
  181. current  line),  the last line to be moved (hitting  <return>  specifies
  182. move the first line only), and where you  want  the  range  to  be moved
  183. (hitting 0 aborts the move).
  184.  
  185.      Choosing the  (Q)  command saves all changes in a new FILES.BBS for
  186. the current area.  The  old  one  is renamed to FILES.BAK.  You may then
  187. choose a new file area for shuffling or (Q)uit and exit shuffle.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. SHUFFLE v1.30                 -3-             Call Met-Chem 203/281-7287
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208. Shareware
  209. ---------
  210.  
  211.      If you  like  and use SHUFFLE, especially if your FIDO is sponsored
  212. by  a  commercial  establishment,  your  contribution  would be  greatly
  213. appreciated.  Please make all checks payable to:
  214.  
  215.      Robert J. Lederman
  216.      7001 Yale Station
  217.      New Haven, CT 06520
  218.  
  219. Nevertheless, any comments or suggestions are solicited.  You  can  post
  220. them, and  receive  the latest version of SHUFFLE on Met-Chem Fido 16/42
  221. in New Haven, 203/281-7287.
  222.  
  223.  
  224. Recent Release History
  225. ----------------------
  226.  
  227.      Version 1.3 has  a  completely rewritten non-Turbo APPEND procedure
  228. that solves previous bugs  in  redirecting  FILES.BBS entries.  Comments
  229. may now be redirected.  The (E)dit command can now  be  used  to  change
  230. file names in FILES.BBS without actually renaming the  file.  The (M)ove
  231. command has been  added  to  allow  EDLIN-style moving of text.  The new
  232. (I)nsert  command  inserts  blank  lines that can  be  changed  to  File
  233. descriptions or comments using the improved  (E)dit  command.   The  new
  234. (O)rphan command searches the active subdirectory for files  not  listed
  235. in FILES.BBS and appends them to the end for further (E)diting.
  236.  
  237.      Versions 1.22b through  1.22f  attempted  to  fix  a  sporadic  and
  238. unexplained failure to redirect FILES.BBS entries.  It  derived  from  a
  239. bug in Turbo Pascal's APPEND procedure.
  240.  
  241.      Version 1.22 adds the (R)ename feature.
  242.  
  243.      Version 1.21 Was incorrectly released, and did not correctly append
  244. redirected FILES.BBS entries to the target  file  area  FILES.BBS.   The
  245. wrong program was incorporated into the library.  Sorry.
  246.  
  247.      Version  1.20  allows  quick-response:  no   unnecessary   carriage
  248. returns.
  249.  
  250.  
  251. Upcoming Features
  252. -----------------
  253.  
  254.      Expect  future  versions of SHUFFLE to have some of  the  following
  255. features:
  256.  
  257.  
  258.  
  259.  
  260.  
  261. SHUFFLE v1.30                 -4-             Call Met-Chem 203/281-7287
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.   -  Full-screen display  of  multiple  FILES.BBS  entries,  using VT100
  275.      commands for remote operation.
  276.  
  277.   -  Ability  to  redirect FILES.BBS entries to  predetermined  line  on
  278.      target FILES.BBS  (for  redirecting new files to the top of the new
  279.      FILES.BBS, for instance).
  280.  
  281.   -  Ability  to  Incorporate/Delete file creation date  into  FILES.BBS
  282.      entries.
  283.  
  284.   -  Ability to move files across disk drives.
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. SHUFFLE v1.30                 -5-             Call Met-Chem 203/281-7287
  328.  
  329.  
  330.  
  331.